Extensions and DriversContents Figures, Tables, and ListingsAbout This Book Figure P-1 What to ReadChapter Organization Conventions Used in This Book
Special FontsTypes of NotesNumerical Formats!Type Definitions for Enumerations
IllustrationsDevelopment Environment Developer Products and Support/Introduction to Printing Extensions and Drivers:About QuickDraw GX Printing Extensions and Printer Drivers"QuickDraw GX Printing and Messages#Figure 1-1 A printing message chainPrint Imaging SystemsETable 1-1 Print imaging systems that QuickDraw GX supports(continued)Printing Phases.Figure 1-2 The phases of QuickDraw GX printing+Extensions, Drivers, and the User Interface6Using Printing Extensions and Printer Drivers Together1Figure 1-3 Using multiple extensions concurrently?Figure 1-4 Several functions handling the GXDespoolPage messageAUsing Resources to Create Printing Extensions and Printer Drivers Overriding Printing Messages)Defining Components of the User Interface<Planning How to Write a Printing Extension or Printer DriverPrinting ExtensionsAbout Printing ExtensionsPrinting Extension Tasks#Adding Panels to Print Dialog BoxesIFigure 2-1 The background picture panel displayed in the Print dialog box Modifying a Page During Spooling Modifying a Page During Imaging+Modifying the Device Communications Process
Developing a Printing ExtensionKTable 2-1 Files used to implement the background picture printing extensionSFigure 2-2 A page printed while the background picture printing extension is activeThe Jump TableSTable 2-2 Printing messages overridden by the background picture printing extensionOListing 2-1 The override resource for the background picture printing extensionHListing 2-2 The jump table for the background picture printing extension The Printing Message OverridesBTable 2-3 Implementation types for QuickDraw GX printing messages !Choosing the Messages to OverrideForwarding Messages3Listing 2-3 Forwarding the GXJobPrintDialog messageSending Messages-Handling Exceptions in Your Message Overrides;Listing 2-4 Using the nrequire macro for exception handlingBListing 2-5 Using the nrequire_action macro for exception handling7Implementing the Background Picture Extension Functions&Initializing the Extension Environment.Listing 2-6 The BWInitialize override function'Listing 2-7 The InitGlobalData function9Adding a Background Picture Panel to the Print Dialog Box2Listing 2-8 The BWJobPrintDialog override function,Listing 2-9 The BackwashCollection structure)Listing 2-10 The SetupPrintPanel function1Handling an Event in the Background Picture Panel,Listing 2-11 The gxPanelInfoRecord structureKTable 2-4 Panel events handled by the background picture printing extension5Listing 2-12 The BWHandlePanelEvent override function+Listing 2-13 The OpenBackwashPanel function0Storing the Background Picture in the Spool File4Listing 2-14 The BWCreateSpoolFile override function%Listing 2-15 The AddBackwash function'Adding the Background Picture to a Page'Listing 2-16 The BWDespoolPage functionClosing the Spool File3Listing 2-17 The BWCloseSpoolFile override function:Shutting Down the Background Picture Extension Environment-Listing 2-18 The BWShutDown override function&Using Resources in Printing Extensions<Table 2-5 Resource types used to define a printing extension1Defining Code Segments in Your Printing Extension:Defining Version Compatibility for Your Printing Extension\Listing 2-19 The QuickDraw GX version resource for the background picture printing extensionYListing 2-20 The standard version resources for the background picture printing extension-Defining the Scope of Your Printing Extension6Table 2-6 Identifiers for the extension scope resourceWListing 2-21 The extension scope resource for the background picture printing extension4Listing 2-22 An example of extension scope resources$Optimizing the Use of Your Extension=Listing 2-23 An example of an extension optimization resource2Specifying Which Messages Your Extension Overrides8Listing 2-24 Override resources for a printing extension,Defining the Loading Order of Your Extension2Table 2-7 Loading order constants for an extensionMListing 2-25 The extension load resource for the background picture extensionPrinter DriversAbout Printer Drivers Writing Data to the Spool File Reading Data From the Spool File Converting QuickDraw GX Shapes&Communicating With the Printing DeviceInterfacing With the Finder Providing a Chooser Interface$Handling Status and Alert ConditionsDFigure 3-1 The printing status displayed in a desktop printer window;Providing Compatibility With the Macintosh Printing Manager Writing Printer Driver FilesNTable 3-1 Files used to implement the ImageWriter II printer driver(continued)$Message Overrides and the Jump TableVTable 3-2 Printing messages overridden by the ImageWriter II printer driver(continued)IListing 3-1 Two override resources from the ImageWriter II printer driver@Listing 3-2 The jump table for the ImageWriter II printer driverThe Message Overrides!Choosing the Messages to OverrideMTable 3-3 Message overrides for the LaserWriter IIg printer driver(continued)Forwarding Messages3Listing 3-3 Overriding the GXRasterLineFeed messageSending Messages-Handling Exceptions in Your Message Overrides&Using the Printing-Related Collections Figure 3-2 The job collectionETable 3-4 Tag ID constants for items in the job collection(continued)7The QuickDraw GX ImageWriter II Printer Driver Messages+Initializing the ImageWriter II Environment:Listing 3-4 Initializing the ImageWriter II printer driver/Providing the Application With Printing Options0Listing 3-5 Modifying the default printer object_Table 3-5 Color values for an eight-color view device for the ImageWriter II printer(continued)3Establishing the Preferred Printing CharacteristicsOListing 3-6 Establishing the printing resolution for the ImageWriter II printer9Listing 3-7 Determining the preferred job-formatting mode)Storing the Current Printer Configuration;Listing 3-8 Opening the connection with the printing deviceNListing 3-9 Getting information about the configuration of the printing device!Responding to Direct-Mode Queries<Listing 3-10 Responding to a query about the job format mode&Setting Up the Parameters for Printing;Listing 3-11 Setting up the constant data for the print job+Listing 3-12 Establishing the print quality Managing Special Page HandlingEListing 3-13 Determining if the print job uses any manually fed pages/Listing 3-14 Finding the manual-feed paper name:Displaying Status Information and the Printing Alert BoxesLListing 3-15 Displaying a printing alert box with printer status informationLTable 3-6 Predefined alert conditions for printing device drivers(continued)4Checking for When an Alert Condition Resolves Itself?Listing 3-16 Checking if an alert condition has resolved itself(Filling In Alert Information at Run Time4Listing 3-17 Modifying alert information at run time&Displaying Status Text During PrintingMTable 3-7 Status text IDs in the page transmission status resource(continued))Rendering the Page on the Printing DeviceTerminating the Print Job&Listing 3-18 Terminating the print job4Providing Compatibility in the ImageWriter II DriverColor PrintingColor Matching$Color Matching on PostScript Devices7Choosing a Color Space for a PostScript Printing Device(Table 3-8 PostScript color-space choices!Using PostScript’s Color Matching Generating Portable PostScriptUsing Resources in DriversCTable 3-9 Resource types used to define a printer driver(continued)%Defining Code Segments in Your Driver6Defining Version Compatibility for Your Printer DriverTListing 3-19 The QuickDraw GX version resource for the ImageWriter II printer driver/Specifying Which Messages Your Driver OverridesEListing 3-20 Override resources for the ImageWriter II printer driver/Defining the Imaging System Type of Your Driver+Table 3-10 Imaging system values(continued)NListing 3-21 The imaging system resource for the ImageWriter II printer driver7Specifying How Your Driver Communicates With the DeviceKListing 3-22 Communications resources for the ImageWriter II printer driverfListing 3-23 The buffering and input/output preferences resource for the ImageWriter II printer driver0Defining Network Characteristics for Your DriverDListing 3-24 Capture resources for the ImageWriter II printer driverDefining Status MessagesDListing 3-25 A status resource for the ImageWriter II printer driver?Resources for Compatibility With the Macintosh Printing ManagerMListing 3-26 The customization resource for the ImageWriter II printer driver=Defining Device Characteristics Specific to an Imaging SystemRListing 3-27 The raster preferences resource for the ImageWriter II printer driverNListing 3-28 The raster package resource for the ImageWriter II printer driverWListing 3-29 The raster package controls resource for the ImageWriter II printer driver$
User Interface and Chooser SupportProviding Printing ChoicesThe Chooser and Your DriverDListing 3-30 The look resource for the ImageWriter II printer driver6Defining Desktop Printer Icons for Your Printer Driver5Figure 3-3 The Apple LaserWriter printer driver icons The Desktop Printer Status Icons8Figure 3-4 The QuickDraw GX desktop-printer status icons7Figure 3-5 Desktop printer icons showing printer status"Bundling Your Printer Driver Icons/Table 3-11 File types for desktop printer iconsFListing 3-31 The bundle resource for the ImageWriter II printer driverOListing 3-32 The file reference resources for the ImageWriter II printer driverEListing 3-33 The icon resources for the ImageWriter II printer driverPrinting MessagesAbout the Printing Messages Printing Message Terminology
Using the Printing MessagesPrinting Messages Reference Data Types for Printer DriversThe Print-to-File Structure The Printing Buffer Structure The Page Information StructureEConstants and Data Types for Macintosh Printing Manager Compatibility The Universal Print Structure3Feed Mode Options for the Universal Print Structure/Print Options for the Universal Print Structure;Paper Orientation Options for the Universal Print Structure5Print Quality Modes for the Universal Print Structure7Paper Tray Selections for the Universal Print Structure4Cover Page Options for the Universal Print Structure4Print-Head Motions for the Universal Print Structure1File Save Types for the Universal Print Structure6Constants and Data Types for the Raster Imaging SystemRaster Offscreen Structure Raster Offscreen Plane Structure Raster Offscreen Setup Structure&Raster Offscreen Plane Setup StructureRaster Plane Options Raster Package Bitmap Structure Raster Imaging System StructureRaster Render OptionsRaster Package StructureRaster Package Options:Constants and Data Types for the PostScript Imaging System#PostScript Imaging System StructurePostScript Render OptionsPostScript Glyphs Structure'PostScript Procedure Set List StructurePostScript Query Results6Constants and Data Types for the Vector Imaging SystemVector Halftone Structure#Vector Halftone Component StructureVector Shape StructureVector Shape Options Vector Imaging System StructureVector Render OptionsVector Pen Table Structure Vector Pen Table Entry StructureVector Pen Units'User Interface Constants and Data Types The Panel Information Structure Panel EventsPanel ResponsesPanel Event ActionsParse Range ResultsThe Status StructureTable 4-1 Status type IDsThe Manual Feed StructureThe Display StructurePrinting MessagesTTable 4-2 Communications errors returned by many of the printing messages(continued)Storage Messages GXInitialize
GXStartJobGXCleanupStartJob GXFinishJob GXJobIdle GXStartPageGXCleanupStartPage GXFinishPage GXPrintPageGXJobFormatModeQueryGXParsePageRangePaper-Handling MessagesGXDoesPaperFitColor Profile MessagesGXFindPrinterProfileGXFindFormatProfileGXSetPrinterProfile8Table 4-3 The actions of the GXSetPrinterProfile messageGXSetFormatProfile7Table 4-4 The actions of the GXSetFormatProfile messageSpooling MessagesGXCreateSpoolFile3Table 4-5 Options for the GXCreateSpoolFile message GXSpoolPage GXSpoolDataGXSpoolResourceGXCompleteSpoolFile Despooling Messages GXCountPages
GXImageJobGXCreateImageFile'Table 4-7 Image file options(continued)GXSetupImageDataGXImageDocument GXImagePage GXRenderPageRaster Imaging MessagesGXRasterDataInGXRasterLineFeedGXRasterPackageBitmapPostScript Imaging MessagesGXPostScriptQueryPrinter;Table 4-8 Constants for PostScript query results(continued) GXPostScriptInitializePrinterGXPostScriptResetPrinterGXPostScriptExitServerGXPostScriptGetStatusTextGXPostScriptGetPrinterTextYListing 4-1 Using the GXPostScriptGetPrinterText and GXPostScriptScanPrinterText messagesGXPostScriptScanStatusTextGXPostScriptScanPrinterText"GXPostScriptGetDocumentProcSetListHListing 4-2 An example of the GXPostScriptGetDocumentProcSetList message GXPostScriptDownloadProcSetList'GXPostScriptGetPrinterGlyphsInformationGXPostScriptStreamFont GXPostScriptDoDocumentHeaderGXPostScriptDoDocumentSetup GXPostScriptDoDocumentTrailerGXPostScriptDoPageSetupGXPostScriptSelectPaperTypeGXPostScriptDoPageTrailerGXPostScriptEjectPageGXPostScriptProcessShapeVector Imaging MessagesGXVectorPackageShapeGXVectorLoadPensGXVectorVectorizeShape Device Communications MessagesGXOpenConnectionGXOpenConnectionRetry2Table 4-9 Communications resource types(continued)GXCleanupOpenConnectionGXCloseConnectionGXStartSendPageGXCleanupStartSendPageGXFinishSendPage GXBufferData0Table 4-10 Options for adding data to the buffer GXWriteData GXDumpBuffer GXFreeBufferGXFinishSendPlane
GXPrJobDialog GXPrStlInit GXPrJobInit GXPrDlgMain GXPrValidate GXPrGeneral GXPrJobMergeGXConvertPrintRecordFromGXConvertPrintRecordToGXPrintRecordToJobFinder Dialog Box MessagesGXWriteStatusToDTPWindowGXInitializeStatusAlertGXHandleAlertEventGXHandleAlertStatusGXHandleAlertFilterFinder Menu MessagesGXGetDTPMenuListGXDTPMenuSelect Summary of Printing Messages(Printing Functions for Message Overrides About the Printing Functions
Using the Printing Functions:Displaying Status Information and the Printing Alert Boxes*Managing Paper Trays and Their Paper Types+Listing 5-1 Looping through the paper trays<Storing and Accessing Data Associated With a Desktop Printer.Listing 5-2 Accessing the desktop printer data%Providing Application Imaging OptionsAccessing Driver Data Interfacing With the ChooserEListing 5-3 The Device function for the ImageWriter II printer driver#Using the Message Cleanup Functions8Listing 5-4 Calling the GXCleanupOpenConnection functionSegmenting Your Driver Code
Printing Functions ReferenceConstants and Data TypesTray Index TypeTray Mapping ModesJob Format Mode TableJob Format ModesThe Panel Setup StructurePrinting Panel Kinds Functions!Reporting Information to the UserGXReportStatusGXAlertTheUserGXGetPrintingAlertGXPrintingAlertManaging Paper Trays GXCountTrays
GXGetTrayNameGXGetTrayMappingGXSetTrayPaperTypeGXGetTrayPaperType*Storing and Accessing Desktop Printer DataGXWriteDTPDataGXFetchDTPData$Adding a Panel to a Print Dialog BoxGXSetupDialogPanel(Working With Application Imaging OptionsGXAddPrinterViewDevice GXGetAvailableJobFormatModesGXSetPreferredJobFormatModePrinting Control FunctionsGXGetJobGXGetMessageHandlerResFile GXJobIdleGXSpoolingAbortedGXHandleChooserMessage?Table 5-1 Messages that the Chooser sends to drivers(continued)/Handling Error Conditions in a Message OverrideGXCleanupOpenConnectionGXCleanupStartJobGXCleanupStartPageGXCleanupStartSendPage Segmenting Message Override CodeGXPrintingDispatch
Summary of Printing FunctionsPrinting Resources About the Printing ResourcesResource ID NumberingResource Attributes#Extension and Driver Resource Files Printing Resources ReferenceConstants and Data Types4The Buffering and Input/Output Preferences StructureThe Customization StructureThe Resolution Structure Raster Preferences StructureRaster Render OptionsRaster Package StructureRaster Package Options!Raster Package Controls StructureStandard Number Structure:Resources Used for Printing Extensions and Printer Drivers The Override ('over') Resource Figure 6-1 The override resource*Table 6-1 Override resource IDs(continued)/Table 6-2 Printing message constants(continued).Listing 6-1 An example of an override resource The Version ('vers') Resource+Listing 6-2 QuickDraw GX version resources The Status ('stat') Resource Figure 6-2 The status resource!Table 6-3 Status types(continued)+Listing 6-3 An example of a status resource$The Printing Alert ('plrt') Resource&Figure 6-3 The printing alert resource,Table 6-4 Printing alert versions(continued)FTable 6-5 Icon IDs for a printing alert resource(continued)(continued)OTable 6-6 Default button string values for a printing alert resource(continued)NTable 6-7 Cancel button string values for a printing alert resource(continued)3Listing 6-4 An example of a printing alert resource The Tray Count ('tray') Resource"Figure 6-4 The tray count resource The Tray Name ('tryn') Resource!Figure 6-5 The tray name resource+Resources Used Only for Printing Extensions%The Extension Scope ('scop') Resource'Figure 6-6 The extension scope resourceETable 6-8 Imaging system identifiers for the extension scope resource$Table 6-9 Scope resource identifiersEListing 6-5 An example of a pair of extension resources used together$The Extension Load ('load') Resource&Figure 6-7 The extension load resource,Table 6-10 Extension load priority constants4Listing 6-6 An example of an extension load resource,The Extension Optimization ('eopt') Resource.Figure 6-8 The extension optimization resource;Table 6-11 Extension optimization resource flags(continued)<Listing 6-7 An example of an extension optimization resource&Resources Used Only in Printer Drivers1Table 6-12 Resources used only in printer drivers$The Imaging System ('isys') Resource&Figure 6-9 The imaging system resource4Listing 6-8 An example of an imaging system resourceThe Look ('look') Resource Figure 6-10 The look resource/Table 6-13 Flag constants for the look resource)Listing 6-9 An example of a look resource$The Communications ('comm') Resource.Figure 6-11 The serial communications resource1Table 6-14 Constants for the baud rate(continued)&Table 6-15 Parity constants(continued)-Table 6-16 Constants for stop bits(continued)-Table 6-17 Constants for data bits(continued)/Figure 6-12 Input and output handshaking values+Table 6-18 Handshake error types(continued)JTable 6-19 Status changes that cause driver events to be posted(continued);Listing 6-10 An example of a serial communications resource+Figure 6-13 The PAP communications resource?Listing 6-11 An example of an AppleTalk communications resource4Figure 6-14 The PrinterShare communications resourceAListing 6-12 An example of a PrinterShare communications resource,Figure 6-15 The SCSI communications resource9Listing 6-13 An example of a SCSI communications resource#The Customization ('cust') Resource&Figure 6-16 The customization resourceDTable 6-20 Updriver values for the customization resource(continued)/Table 6-21 Translator setting values(continued)3Listing 6-14 An example of a customization resource The Resolution ('resl') Resource#Figure 6-17 The resolution resource0Listing 6-15 An example of a resolution resource"The Print Record ('PREC') Resource2Listing 6-16 An example of a print record resource$The Dialog Control ('dctl') Resource'Figure 6-18 The dialog control resource Table 6-22 Control item types6Listing 6-17 Two examples of a dialog control resourceLTable 6-23 Cluster type constants for the dialog control resource(continued)?Table 6-24 Frill type constants for the dialog control resourceNTable 6-25 Toggle action-item flags for the dialog control resource(continued)#The Scaling Table ('stab') Resource&Figure 6-19 The scaling table resource<The Buffering and Input/Output Preferences ('iobm') Resource?Figure 6-20 The buffering and input/output preferences resourceLListing 6-18 An example of a buffering and input/output preferences resource The Capture ('cpts') Resource Figure 6-21 The capture resource,Table 6-26 Capture resource types(continued)CTable 6-27 Substitution strings for the capture resource(continued)?Listing 6-19 Examples of capture resources for a printer driver(The Print-File Formats ('pfil') Resource+Figure 6-22 The print file formats resource8Listing 6-20 An example of a print-file formats resource(The Raster Preferences ('rdip') Resource+Figure 6-23 The raster preferences resource5Table 6-28 Raster preference option values(continued)RTable 6-29 Flags used for each plane in the raster preferences resource(continued)+Table 6-30 Plane dithering types(continued))Table 6-31 Plane tinting types(continued)8Listing 6-21 An example of a raster preferences resource$The Raster Package ('rpck') Resource'Figure 6-24 The raster package resource,Table 6-32 Raster package options(continued)4Listing 6-22 An example of a raster package resource-The Raster Package Controls ('ropt') Resource0Figure 6-25 The raster package controls resource<Table 6-33 Number types for specifying line feeds(continued)=Listing 6-23 An example of a raster package controls resource The Color Set ('crst') Resource"Figure 6-26 The color set resource/Listing 6-24 An example of a color set resource)The PostScript Scanning ('scan') Resource,Figure 6-27 The PostScript scanning resourceUTable 6-34 Scan string specifications for the PostScript scanning resource(continued)UTable 6-35 Scan offset specifications for the PostScript scanning resource(continued)JTable 6-36 Scan-action specifications for the PostScript scanning resourceMListing 6-25 An example of PostScript scanning resources for a printer driver6The PostScript Procedure Set Control ('prec') Resource9Figure 6-28 The PostScript procedure set control resource5Table 6-37 PostScript procedure data flags(continued)2The PostScript Printer Font Type ('pfnt') ResourceQFigure 6-29 The PostScript printer font type resource for the Adobe character set\Listing 6-26 Examples of PostScript printer font type resources for the Adobe character set QFigure 6-30 The PostScript printer font type resource for the Apple character set_Listing 6-27 An example of a PostScript printer font type resource for the Apple character set UFigure 6-31 The PostScript printer font type resource for an equivalent character setIFigure 6-32 The PostScript printer font type resource for an encoded font,The PostScript Preferences ('pdip') Resource+Figure 6-33 PostScript preferences resource0Table 6-38 PostScript render options(continued) 'Table 6-39 Font stream types(continued) Summary of Printing ResourcesGlossaryIndex
